home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 2002 November / SGI IRIX Installation Tools & Overlays 2002 November - Disc 4.iso / dist / license_eoe.idb / usr / relnotes / license_eoe / ch3.z / ch3
Text File  |  2002-10-15  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        3.  _F_L_E_X_l_m__L_i_c_e_n_s_i_n_g
  9.  
  10.        FLEXlm is the most widely used licensing software used in
  11.        the software industry.  FLEXlm supports node-locked
  12.        licenses, which are licenses which allow an application to
  13.        run on a specific host. No additional software or processes
  14.        other than the application are required for using node-
  15.        locked licensing.
  16.  
  17.        FLEXlm also supports floating (network) licensing, which
  18.        allows software licenses to be available (or float) anywhere
  19.        on a network, instead of being tied to specific machines.
  20.  
  21.        Floating licensing benefits both users and license
  22.        administrators.  Users can make more efficient use of fewer
  23.        licenses by sharing them on the network.  License
  24.        administrators can control who uses the licensed
  25.        application, and the node(s) where the licenses will be
  26.        available. See the _F_L_E_X_l_m _E_n_d _U_s_e_r _M_a_n_u_a_l (in the
  27.        _l_i_c_e_n_s_e__e_o_e._b_o_o_k_s._F_L_E_X_l_m__E_U_M subsystem) for more details
  28.        about the different licensing models supported by FLEXlm.
  29.  
  30.  
  31.        3.1  _F_L_E_X_l_m__L_i_c_e_n_s_i_n_g__S_u_b_s_y_s_t_e_m_s
  32.  
  33.        The FLEXlm licensing software is divided into a number of
  34.        subsystems.  You may need to install different subsystems
  35.        depending on your FLEXlm licensing needs.
  36.  
  37.        If you are using a product which uses only FLEXlm node-
  38.        locked software licensing (each license is specific to one
  39.        node, or system), you only need to install license_eoe
  40.        subsystems that are installed by default.
  41.  
  42.        If you are using a product which uses FLEXlm floating
  43.        licensing, you will need to install the FLEXlm Server
  44.        Software (_l_i_c_e_n_s_e__e_o_e._s_w._f_l_e_x_l_m__s_e_r_v_e_r) subsystem on the
  45.        licensing server. Note that this subsystem does not need to
  46.        be installed on systems that are only licensing clients.
  47.        This subsystem is not installed by default, and will have to
  48.        be explicitly selected for installation in Software Manager.
  49.  
  50.  
  51.  
  52.        3.2  _S_G_I__F_L_E_X_l_m__L_i_c_e_n_s_e__F_i_l_e__C_o_n_v_e_n_t_i_o_n_s
  53.  
  54.        Silicon Graphics has specified a set of conventions for
  55.        managing your FLEXlm license files.  You may choose not to
  56.        follow these conventions, but the 2License Manager tool and
  57.        the license server startup script /_e_t_c/_i_n_i_t._d/_f_l_e_x_l_m have
  58.        been designed to conform to the following rules.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.          1.  FLEXlm node-locked licenses are always kept in the
  75.              file /_v_a_r/_f_l_e_x_l_m/_l_i_c_e_n_s_e._d_a_t on the node-locked host.
  76.  
  77.          2.  FLEXlm floating licenses generated for the license
  78.              server <<<<hhhhoooossssttttnnnnaaaammmmeeee>>>> are always kept in the file
  79.              /var/flexlm/license_<<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>.dat on both the license
  80.              server and on client hosts.
  81.  
  82.              _N_O_T_E: In order for a client system to use the licenses
  83.              on a license server, a current copy of the license
  84.              server's license file must be kept on the client
  85.              system.
  86.  
  87.  
  88.        3.3  _L_i_c_e_n_s_e__F_i_l_e__D_a_t_a_b_a_s_e
  89.  
  90.        Applications that are licensed with FLEXlm libraries from
  91.        Silicon Graphics, which are distributed in the _l_i_c_e_n_s_e__d_e_v
  92.        product, have an enhanced license file search capability.
  93.  
  94.        Applications licensed with the FLEXlm libraries from
  95.        Globetrotter software will search for a license at the
  96.        default location, /_u_s_r/_l_o_c_a_l/_f_l_e_x_l_m/_l_i_c_e_n_s_e_s/_l_i_c_e_n_s_e._d_a_t,
  97.        unless the environment variable LM_LICENSE_FILE is set.
  98.  
  99.        For applications licensed with the SGI version of the FLEXlm
  100.        libraries, if the environment variable LM_LICENSE_FILE is
  101.        not set, the _L_i_c_e_n_s_e _F_i_l_e _D_a_t_a_b_a_s_e is used to determine the
  102.        locations of all known license files, and the search for a
  103.        license will be conducted on these files.  This database is
  104.        stored in the file /_v_a_r/_f_l_e_x_l_m/_l_i_c_e_n_s_e_f_i_l_e._d_b.
  105.  
  106.        Each entry in _l_i_c_e_n_s_e_f_i_l_e._d_b specifies either a license
  107.        file, or a directory which directly or indirectly contains a
  108.        license file.  For more information on its use and syntax,
  109.        please refer to the manual page for _L_i_c_e_n_s_e_M_a_n_a_g_e_r(_1_M).
  110.  
  111.  
  112.        3.4  _W_e_b__L_i_c_e_n_s_e__R_e_q_u_e_s_t__a_n_d__A_u_t_o_m_a_t_i_c__L_i_c_e_n_s_e__I_n_s_t_a_l_l_a_t_i_o_n
  113.  
  114.        The Silicon Graphics Software Licensing Page on the World
  115.        Wide Web supports license request and automatic installation
  116.        using your web browser. Please refer to the Silicon Surf
  117.        Software Licensing Page at
  118.        _h_t_t_p://_w_w_w._s_g_i._c_o_m/_P_r_o_d_u_c_t_s/_l_i_c_e_n_s_e._h_t_m_l for more
  119.        information.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        3.5  _I_n_s_t_a_l_l_i_n_g__F_L_E_X_l_m__N_o_d_e_-_l_o_c_k_e_d__L_i_c_e_n_s_e_s
  141.  
  142.        A FLEXlm node-locked license can be installed by using
  143.        License Manager, or by directly entering it into the file
  144.        /var/flexlm/license.dat using a text editor.  Once
  145.        installed, it will be immediately available for use by an
  146.        application.
  147.  
  148.  
  149.        3.6  _I_n_s_t_a_l_l_i_n_g__F_L_E_X_l_m__F_l_o_a_t_i_n_g__L_i_c_e_n_s_e_s
  150.  
  151.        A FLEXlm floating license can be installed by using License
  152.        Manager, or by directly entering it into the floating
  153.        license file /var/flexlm/license_<<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>.dat, where
  154.        <<<<hhhhoooossssttttnnnnaaaammmmeeee>>>> is the name of the license server host.
  155.  
  156.        Newly installed FLEXlm floating licenses are not available
  157.        for use unless the licensing daemon _l_m_g_r_d(_1_M) is running,
  158.        and the new contents of the license file has been read.
  159.  
  160.        If the FLEXlm floating license was installed using License
  161.        Manager, release 3.3 or higher, License Manager will
  162.        automatically start the licensing daemon if it is not
  163.        already running, and have it read the license file with the
  164.        new floating licenses.
  165.  
  166.        If the license was installed manually, this license will not
  167.        be available for use until the license daemon is properly
  168.        configured and started as documented in the following
  169.        section.
  170.  
  171.  
  172.        3.7  _I_n_s_t_a_l_l_i_n_g _L_i_c_e_n_s_e_s _a_n_d _C_o_n_f_i_g_u_r_i_n_g _t_h_e _L_i_c_e_n_s_e _S_e_r_v_e_r
  173.             _M_a_n_u_a_l_l_y
  174.  
  175.        To install a FLEXlm floating license and configure the
  176.        license server startup script without using License Manager,
  177.        the following steps should be used.  If you are just
  178.        restarting the license server after installing a new license
  179.        file, go to step 6.
  180.  
  181.  
  182.          1.  Open a shell window by choosing "Unix Shell" from the
  183.              Desktop toolchest.
  184.  
  185.          2.  Log in as root by typing "su" at the shell prompt.
  186.              Type in the root password if you have one.
  187.  
  188.          3.  Create the server license file.  Create a new license
  189.              file in "/_v_a_r/_f_l_e_x_l_m/" and use a text editor (e.g.,
  190.              _j_o_t) to add the network licenses to that file.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.              Your server license file should include the name of
  207.              the server machine in the name of the file.  For
  208.              example, if your server machine is named "control",
  209.              you should create a license file with the name
  210.              "/_v_a_r/_f_l_e_x_l_m/_l_i_c_e_n_s_e__c_o_n_t_r_o_l._d_a_t".
  211.  
  212.              Using the server machine name in the name of the
  213.              license file allows the license file to be copied to
  214.              all client machines without overwriting other license
  215.              files on those machines.
  216.  
  217.          4.  Configure the FLEXlm Network License Server daemon to
  218.              use the new license file.  Edit the configuration
  219.              files "/_e_t_c/_c_o_n_f_i_g/_l_m_g_r_d._o_p_t_i_o_n_s" and
  220.              "/_e_t_c/_c_o_n_f_i_g/_l_m_d_o_w_n._o_p_t_i_o_n_s" using a text editor (such
  221.              as _j_o_t).  Change the configuration files to indicate
  222.              the name of your new license file.  For example, if
  223.              your new license file is named
  224.              "/_v_a_r/_f_l_e_x_l_m/_l_i_c_e_n_s_e__c_o_n_t_r_o_l._d_a_t", edit
  225.              "/_e_t_c/_c_o_n_f_i_g/_l_m_g_r_d._o_p_t_i_o_n_s" and
  226.              "/_e_t_c/_c_o_n_f_i_g/_l_m_d_o_w_n._o_p_t_i_o_n_s" to contain the following:
  227.  
  228.                ----cccc ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeee____ccccoooonnnnttttrrrroooollll....ddddaaaatttt
  229.  
  230.          5.  Type "chkconfig flexlm on".
  231.  
  232.          6.  Restart the Server.  To stop the server, use the
  233.              following command:
  234.  
  235.                ////eeeettttcccc////iiiinnnniiiitttt....dddd////fffflllleeeexxxxllllmmmm ssssttttoooopppp
  236.  
  237.              To restart the server, or to start it for the first
  238.              time, use the following command:
  239.  
  240.                ////eeeettttcccc////iiiinnnniiiitttt....dddd////fffflllleeeexxxxllllmmmm ssssttttaaaarrrrtttt
  241.  
  242.          7.  If you still have problems running applications which
  243.              use FLEXlm network licensing, you can configure the
  244.              FLEXlm Network License Server daemon to write output
  245.              to a log file.  The contents of the log file may
  246.              enable you to determine the cause of the problem.
  247.  
  248.              Edit the configuration file
  249.              "/_e_t_c/_c_o_n_f_i_g/_l_m_g_r_d._o_p_t_i_o_n_s" to also contain the
  250.              following:
  251.  
  252.                ----llll ////vvvvaaaarrrr////aaaaddddmmmm////fffflllleeeexxxxllllmmmm....lllloooogggg
  253.  
  254.              Restart the server (as above).  You will be able to
  255.              monitor the behavior of the server by looking at the
  256.              file "/_v_a_r/_a_d_m/_f_l_e_x_l_m._l_o_g".
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        3.8  _A_c_c_e_s_s_i_n_g__l_i_c_e_n_s_e__s_e_r_v_e_r_s__t_h_r_o_u_g_h__a__f_i_r_e_w_a_l_l
  273.  
  274.        Many firewalls require that port numbers be specified to the
  275.        firewall. Current lmgrds support this.  Add "PORT = number"
  276.        to each DAEMON line. Also allow firewall access to all port
  277.        numbers and the port number on the SERVER line.  See
  278.        '_h_t_t_p://_w_w_w._g_l_o_b_e_t_r_o_t_t_e_r._c_o_m/_f_l_x_l_m_f_a_q/_c_h_a_p_6._h_t_m#_Q_6._6" for
  279.        details.
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.